CREATE EXTENSION

CREATE EXTENSION — 安装一个扩展

大纲：

CREATE EXTENSION [ IF NOT EXISTS ] extension_name

[ WITH ] [ SCHEMA schema_name ]

[ VERSION version ]

[ CASCADE ]

描述：

CREATE EXTENSION把一个新的扩展载入到当前数据库中。不能有同名扩展已经被载入。

载入一个扩展本质上是运行该扩展的脚本文件。该脚本通常将创建新的 SQL对象，例如函数、数据类型、操作符以及索引支持 方法。CREATE EXTENSION会额外地记录所有被创建对象的标识，这样发出DROP EXTENSION时可以删除它们。运行CREATE EXTENSION的用户成为扩展的所有者， 以进行以后的特权检查，并且通常也成为由扩展的脚本创建的任何对象的所有者。

通常，加载扩展需要与创建扩展组件对象所需的特权相同的特权。对于许多扩展，这意味着需要超级用户特权。 但是，如果扩展名在其控制文件中标记为trusted，则该扩展名可以由对当前数据库具有CREATE特权的任何用户安装。 在这种情况下，扩展对象本身将由主叫用户拥有，但是包含的对象将由引导超级用户拥有（除非扩展的脚本将其明确分配给主叫用户）。 此配置使呼叫用户有权删除该扩展名，但不能修改其中的单个对象。

参数：

IF NOT EXISTS

已有同名扩展存在时不要抛出错误。这种情况下会发出一个提示。 注意，不保证现有的扩展与将要从当前可用的脚本文件创建的脚本 有任何相似。

extension_name

要安装的扩展的名称。

schema_name

假定该扩展允许其内容被重定位，这是要在其中安装该扩展的对象的模式名称。被提到的模式必须已经存在。如果没有指定并且该扩展的控制文件也没有指定一个模式，将使用当前的默认对象创建模式。

如果该扩展在其控制文件中指定了一个schema参数，那么不能用SCHEMA子句覆盖该模式。通常，如果 给出了一个SCHEMA子句并且它与扩展的 schema参数冲突，则会发生错误。不过，如果也给出了CASCADE子句，则schema冲突时会忽略 schema_name。给定的schema_name 将被用来安装任何需要的并且没有在其控制文件中指定 schema的扩展。

记住扩展本身被认为不在任何模式中：扩展具有无限定的名称，并且 要在整个数据库范围内唯一。但是属于扩展的对象可以在模式中。

version

要安装的扩展的版本。这可以写成一个标识符或者一个字符串。 默认版本在该扩展的控制文件中指定。

CASCADE

自动安装这个扩展所依赖的任何还未安装的扩展。它们的依赖也会同样被自动安装。如果给出SCHEMA子句，它会应用于这种方式下安装的所有扩展。这个语句的其他选项不会被应用于自动安装的扩展。特别地，这些自动安装的扩展的默认版本将被选中。

注解：

在使用CREATE EXTENSION载入扩展到数据库中之前，必须先安装好该扩展的支持文件。关于安装扩展的信息可以在额外提供的模块中找到。

当前可以用于载入的扩展可以在系统视图 pg_available_extensions 或者pg_available_extension_versions 中看到。

​

示例：

安装hstore扩展到当前数据库中，将其对象放置在 addons模式中：

CREATE EXTENSION hstore SCHEMA addons;

另一种方法：

SET search_path = addons;
CREATE EXTENSION hstore;

另见

ALTER EXTENSION, DROP EXTENSION